home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audiocddat / CDopen.z / CDopen
Encoding:
Text File  |  1998-10-20  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCDDDDooooppppeeeennnn((((3333ddddmmmm))))                                                        CCCCDDDDooooppppeeeennnn((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CDopen - opens a CD-ROM drive for audio use
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ccccddddaaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      CCCCDDDDPPPPLLLLAAAAYYYYEEEERRRR**** CCCCDDDDooooppppeeeennnn((((cccchhhhaaaarrrr**** ddddeeeevvvv,,,, cccchhhhaaaarrrr**** ddddiiiirrrreeeeccccttttiiiioooonnnn))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  18.      _d_e_v         The name of the devscsi file associated with the CD-ROM
  19.                  device.  E.g.  /dev/scsi/sc0d4l0.  If _d_e_v is NULL, then
  20.                  CCCCDDDDooooppppeeeennnn((((3333ddddmmmm)))) will consult the hardware inventory table to
  21.                  locate a CD-ROM drive.
  22.  
  23.      _d_i_r_e_c_t_i_o_n   A pointer to one of "r", "w", or "rw" indicating the
  24.                  direction of the I/O desired.
  25.  
  26. RRRREEEETTTTUUUURRRRNNNNEEEEDDDD VVVVAAAALLLLUUUUEEEE
  27.      Upon successful completion, CCCCDDDDooooppppeeeennnn((((3333ddddmmmm)))) returns a pointer to a CCCCDDDDPPPPLLLLAAAAYYYYEEEERRRR,
  28.      an opaque type defined in _c_d_a_u_d_i_o._h. Otherwise a value of null (0) is
  29.      returned and _e_r_r_n_o is set to indicate the error.
  30.  
  31. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  32.      CCCCDDDDooooppppeeeennnn((((3333ddddmmmm)))) opens the devscsi device associated with the CD-ROM and
  33.      determines if the device is a recognized type of CD-ROM drive.
  34.      Recognized devices are Sony and Toshiba. If it is successful it allocates
  35.      and initializes a CCCCDDDDPPPPLLLLAAAAYYYYEEEERRRR structure for the device and returns a pointer
  36.      to it.  You use this structure in all function calls that access the CD-
  37.      ROM.
  38.  
  39.      The device is opened for reading, writing, or reading and writing
  40.      according to the ddddiiiirrrreeeeccccttttiiiioooonnnn argument.  Currently only reading is
  41.      supported.  This argument provides a path forward toward writable CD's.
  42.      CCCCDDDDooooppppeeeennnn((((3333ddddmmmm)))) also attempts to select the CD-ROM mode that enables transfer
  43.      of audio data from audio CD's across the SCSI bus.  Only the Toshiba CD-
  44.      ROM supports this feature.  The _s_c_s_i__a_u_d_i_o flag is set in the CCCCDDDDSSSSTTTTAAAATTTTUUUUSSSS
  45.      structure [see CCCCDDDDggggeeeettttssssttttaaaattttuuuussss((((3333ddddmmmm))))] to indicate whether the mode was
  46.      successfully selected.  The opened CD-ROM can be used as a player
  47.      regardless of the success or failure of this operation.
  48.  
  49.      CCCCDDDDooooppppeeeennnn((((3333ddddmmmm)))) will fail and no CDPLAYER structure will be created if one or
  50.      more of the following are true:
  51.  
  52.  
  53.      [ENODEV]       No CD-ROM device could be found.
  54.  
  55.      [ENODEV]       The device didn't respond to an inquiry request.
  56.  
  57.      [ENODEV]       The CD-ROM was of an unrecognized type.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCDDDDooooppppeeeennnn((((3333ddddmmmm))))                                                        CCCCDDDDooooppppeeeennnn((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      [ENOMEM]       The malloc(3) call to acquire memory for the CDPLAYER
  75.                     structure failed.
  76.  
  77.      [EBUSY]        The CD-ROM device was busy.
  78.  
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      CDintro(3dm), CDclose(3dm), CDgetstatus(3dm), CDgettrackinfo(3dm),
  82.      CDeject(3dm), CDreadda(3dm), CDseek(3dm), CDstop(3dm),
  83.      CDtogglepause(3dm), CDallowremoval(3dm), CDpreventremoval(3dm),
  84.      CDseek(3dm), CDseektrack(3dm), CDseekblock(3dm), CDplay(3dm),
  85.      CDplayabs(3dm), CDplaytrack(3dm), CDplaytrackabs(3dm),
  86.  
  87.  
  88. AAAAUUUUTTTTHHHHOOOORRRR
  89.      Roger Chickering, Mark Callow
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.